home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / bbsee22c.zip / CONVERT.DOC < prev    next >
Text File  |  1992-07-18  |  4KB  |  79 lines
  1. Note these two program are no longer being distributed.  If you need
  2. them please contact Martin Vallevand as described in BBSEE.DOC
  3.  
  4.  
  5.                           BBSee Catalog Database Conversion.
  6.  
  7.           1.   CONVERT.EXE
  8.  
  9.           The  layout of the catalog  file database has  changed with BBSee
  10.           version  2,  from version  1.   There  are  now three  files, the
  11.           catalog, archive  and volume  files within the  catalog database.
  12.           If you have an existing BBSee version database you must perform a
  13.           two  step semi-automatic conversion  if you wish  you continue to
  14.           use the new and improved version.
  15.  
  16.                                       Step One.
  17.  
  18.           The first step  of the conversion is to create  the new files for
  19.           the  catalog  and  archive  contents, and  import  your  existing
  20.           catalog database information.   To initiate  this step, from  the
  21.           sub-directory where you have bbsee.cfg, execute the command 
  22.  
  23.           CONVERT /INITIAL
  24.  
  25.           This process creates  two intermediate files needed  in step two,
  26.           the new catalog files  temporarily named newcat.db and newcat.idx
  27.           and a file called BBSEE.CVT.
  28.  
  29.           BBSEE.CVT  is a file that  contains information for  later use in
  30.           CONVERT.   It is important  that you  change the first  letter of
  31.           each line  of this file to  match the drive where  you would have
  32.           cataloged  the specified volume. (This is required, if you are to
  33.           ever  wish to  use BBSee's  automated extract and  copy features.
  34.           Refer to BBSee's documentation for further information).  BE SURE
  35.           that the editor  you use to change the BBSEE.CVT  does not change
  36.           anything  but the first letter, (some place tab characters in the
  37.           file without you even knowing).
  38.  
  39.                                       Step Two.
  40.  
  41.           Once  you are satisfied with the BBSEE.CVT file, start the second
  42.           pass with the command
  43.  
  44.           CONVERT /VOLUME.
  45.  
  46.           This pass reads  the BBSEE.CVT  file and creates  the new  volume
  47.           database.   On  successful  exit, CONVERT  deletes its  temporary
  48.           files, and you should be ready to run BBSee Version 2.
  49.  
  50.           Note  that the  conversion process  keeps a  backup copy  of your
  51.           existing  file, at  the end  of pass  two, named  BACKCAT(.db and
  52.           .idx).   Once  you are  satisfied that  BBSee 2.0  is functioning
  53.           properly you can delete these files.  If you wish  you can backup
  54.           the catalog.db  and  idx  file(s)  that you  use  before  running
  55.           CONVERT.  The  conversion does not modify the  master description
  56.           database so these do not need to be backed up.
  57.  
  58.  
  59.  
  60.           If you use more than one catalog file that are stored in the same
  61.           directory, you will need to  individually and manually change the
  62.           archives and volume filenames after the conversion.
  63.  
  64.           Note that the  DOS serial number  is not incorporated in  the old
  65.           file structure.   If you use  DOS 4.0 or higher  and the disk  do
  66.           actually have a DOS serial  number, during recatalog of converted
  67.           disks, you  will be notified that  the serial number for  the old
  68.           disk  don't  match.   You will  need to  uncatalog followed  by a
  69.           catalog to correct this situation.
  70.  
  71.           2.   FIXGIF.EXE (note for version 2.0 users)
  72.  
  73.           This program is  designed to correct a bug caused  by the initial
  74.           BBSee version  1  to version  2  conversion.   If  you  used  the
  75.           previous CONVERT.EXE program  (from BBSEE20C.ZIP), running FIXGIF
  76.           should  correctly  re-initialize  the  converted  GIF  resolution
  77.           field.  If you have any problems please contact me (see the
  78.           BBSee documentation).
  79.